home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / cpp_libs / sos3-2_r.lha / README.install.SOS3-2 < prev   
Text File  |  1992-02-13  |  8KB  |  190 lines
  1. (1) Introduction
  2. ----------------
  3.  
  4. This file describes the installation of SOS version 3-2.
  5.  
  6. SOS is the STONE object management system developed by Forschungszentrum
  7. Informatik (FZI) as a contribution to the STONE project. This project
  8. (supported by grant no. ITS8902A7 from the BMFT) aims at the development of
  9. a software engineering environment for education purposes and is carried out
  10. as a joint project of nine german universities and research institutions.
  11. An essential feature of STONE is that the object oriented paradigm is pursued
  12. consequently as a key concept. SOS is the common persistent object store for
  13. all tools within the STONE environment.
  14.  
  15. Since SOS is a prototype you have to be aware of possible bugs. On sending a
  16. short report we will try hard to fix them but we can not give guarantees of any
  17. kind.
  18. More specifically:
  19. FZI DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL
  20. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL FZI BE
  21. LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  22. WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF
  23. CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
  24. WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  25.  
  26. Besides bug reports we are strongly interested in all experiences our users
  27. make with SOS (e.g. sufficiency of data model, performance, ...) and in our
  28. users' application areas and the applications as well.
  29.  
  30. Please mail to: Forschungszentrum Informatik (FZI)
  31.                STONE Projekt
  32.              Haid-und-Neu-Strasse 10-14
  33.              D-7500 Karlsruhe 1
  34.                Germany
  35.  
  36. or email to:    stone@fzi.de
  37.  
  38. Phone:          ++49-721-9654-601
  39. Fax:            ++49-721-9654-609
  40. Teletex:        721 190 fziKA
  41.  
  42. On sending a short note (preferably via email to stone@fzi.de) we'll keep
  43. you informed about SOS enhancements, new versions, etc.
  44.  
  45.  
  46. (2) System Requirements
  47. -----------------------
  48.  
  49. The installation has been tested for Sun3, Sun4 running os4 and the C++
  50. compilers GNU g++ (versions 1.37.0 up to 1.39.1) and AT&T C++ version 2.0/2.1.
  51. Some of the graphical tools comprised in the SOS version are based on X-windows
  52. (X11R4).
  53. Porting to other machines shouldn't make problems if there is a GNU g++
  54. compiler available.
  55.  
  56. An SOS version installed using the compilation switch settings as delivered
  57. requires about 40 MByte disk space.
  58.  
  59.  
  60. (3) Starting the Installation
  61. -----------------------------
  62.  
  63. Your local directory should now contain six files:
  64.    README.install.SOS3-2: this file
  65.    README.changes.SOS3-2: contains differences to the last delivered version.
  66.    README.SOS3-2    : short description of the SOS version 3-2.
  67.    LICENCE        : licence conditions for the SOS version 3-2.
  68.    INSTALL.SOS3-2          : UNIX script performing most of the installation.
  69.    SOS3-2.tar.Z        : compressed tar file containing the SOS version 3-2.
  70.    
  71.  
  72. Before the actual installation is started, you should move at least the last 
  73. two files (or all six files) to the directory where you want to install SOS.
  74.  
  75. Now, change directory to the directory containing INSTALL.SOS3-2 and SOS3-2.tar.Z.
  76. SOS will be installed in this directory.
  77.  
  78. Most parts of the installation are performed by the script INSTALL.SOS3-2. The
  79. installation consists of three phases:
  80.  - First, INSTALL.SOS3-2 unpacks the SOS version and installs it in your local
  81.    directory tree.
  82.  - Afterwards, you perform any adaptions to your local environment not done in
  83.    the first phase.
  84.  - Finally, INSTALL.SOS3-2 triggers a bootstrap of the SOS version.
  85.  
  86. Start by typing:
  87.  
  88.    INSTALL.SOS3-2
  89.  
  90. This will unpack SOS3-2.tar.Z and afterwards ask you for the C++ compiler to be
  91. used (see also below). For the GNU compiler type 'y' or 'Y', for the AT&T
  92. compiler type 'n' or 'N'.
  93. INSTALL.SOS3-2 will now change some paths to integrate the SOS version into your
  94. directory tree.
  95.  
  96.  
  97. (4) Customization at Your Site
  98. ------------------------------
  99.  
  100. Some adaptions are difficult to perform automatically. Therefore, you have to
  101. finish the customization by yourself. You might consider to refer to the SOS
  102. Users Guide contained in SOS3-2/doc/system for an explanation of some of the
  103. terms used in the sequel.
  104.  
  105. We had some problems with the compilation driver CC (version 1.7.3.1)
  106. included in the AT&T C++ 2.0 distribution. Therefore, you might consider to
  107. adapt your CC script when compiling with the AT&T compilers as follows (a CC
  108. script with the following changes is contained in SOS3-2/bin):
  109.  - Changing line 219 from
  110.       $cfrontC +L +f$A $O <$TEMPDIR/cpptmp >$TEMPDIR/$B$ISUF
  111.    to
  112.       $cfrontC +L +f$A $O <$TEMPDIR/cpptmp \
  113.      | egrep -v '^#line.*\.h\"' \
  114.      > $TEMPDIR/$B$ISUF
  115.    removes #line comments from the output of cfront. These comments caused a
  116.    bus error in subsequent cpp runs at our installation.
  117.  
  118.  - Changing lines 363, 365 from
  119.       echo "$ccC $P $NLO $X" 1>&2
  120.       (cd $TEMPDIR; $ccC $P $NLO $X)
  121.    to
  122.       echo "$ccC $P $NLO $OF $X" 1>&2
  123.       (cd $TEMPDIR; $ccC $P $NLO $OF $X)
  124.    handles the '-o' option in the NOLOAD case.
  125.  
  126.  - When using AT&T 2.0 (and NOT 2.1) then you must transform line 38 in 
  127.    SOS3-2/src/psm/psm.c to "#include <sys/time.h>", i.e. you must delete "//".
  128.    
  129. The SOS makefile is based on macros defined in SOS3-2/commands.mk. These
  130. macros define in particular the compilers and the compilation options used
  131. during the generation of the SOS version. You might want to customize these
  132. macros according to your local installation.
  133.  
  134. In the header of the SOS makefile SOS3-2/Makefile you will find the four
  135. macros ECHOXX, LDXX, CRTXX, and LIBSXX. These macros define default options for
  136. the incremental loading facility of SOS. As described in the Users Guide, these
  137. defaults can be overridden at runtime of an SOS application by defining an
  138. environment variable. Incremental loading is only operable if the SOS version
  139. is installed with the GNU compiler (see above). Otherwise, the macros are not
  140. used and may therefore define arbitrary values.
  141.   ECHOXX ... set this to TRUE (FALSE), if the names of incrementally loaded
  142.          object files are (not) to be echoed on stderr.
  143.   LDXX   ... the pathname of the link editor distributed with the GNU
  144.          C++ compiler
  145.   CRTXX  ... the pathname of the object module containing startup code for the
  146.          incrementally loaded code
  147.   LIBSXX ... linker options for standard libraries to be appended to each
  148.          link command
  149.  
  150. Furthermore, the locking mechanism used by the persistent storage manager to
  151. implement process synchronization can be chosen via the macro USE_FCNTL. This
  152. macro is contained in the header of the Makefile, too.
  153. If USE_FCNTL is defined by "-DLOCKD_CORRECT", locks will be claimed using
  154. the Unix system call 'fcntl', otherwise using 'flock'.
  155. In the first case, locks will be respected network wide, in the second case
  156. only among the processes running on a single host.
  157.  
  158. SOS is by default  n o t  generated using network wide locks. The primary
  159. reason for this is an error in the Sun Os 4.1.1 implementation of the lock
  160. daemon required for network wide locks. This error occasionally caused a halt
  161. of the addressed file server. The error ceased to occur after the installation
  162. of an OS patch obtained from Sun (patch no. 100075-07).
  163.  
  164.  
  165. (5) Completing the Installation
  166. -------------------------------
  167.  
  168. After completing the customization, the final phase of the SOS installation
  169. is started by typing
  170.  
  171.    INSTALL.SOS3-2 -boot
  172.  
  173. This triggers the boot process for the SOS version. It will take some time
  174. until the system is built up completely. During the bootstrap the schema
  175. compiler as well as some tools and demonstration programs that are comprised in
  176. the delivered software will be generated.
  177.  
  178. Finally, you are asked whether the object files created during installation
  179. shall be kept or removed. If no error occured, most object files are not
  180. necessary any further since they are bound to libraries or executables,
  181. respectively. In this case you can savely answer the question with 'y' or 'Y'.
  182. Otherwise, type 'n' or 'N' and the object files are kept.
  183. The same holds for the installation files INSTALL.SOS3-2, and SOS3-2.tar.Z which are
  184. removed if you answer the corresponding question 'remove installation files?'
  185. with 'y' or 'Y' and kept if the answer is 'n' or 'N'.
  186.  
  187. This finishes the installation of your SOS version.
  188.  
  189. Have fun with SOS.
  190.